home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 010 / pianodoc.arc / PIANOMAN.DOC next >
Encoding:
Text File  |  1984-12-01  |  12.5 KB  |  231 lines
  1.  
  2.  
  3.    █▀▀▀█▄    ███    ▐█▌     ██▌   █   ▄████▄       ██   ██    ▐█▌     ██▌   █
  4.    █    ▀█    █     █ █     █ █   █   █    █       █▐▌ ▐▌█    █ █     █ █   █
  5.    █     █    █    ▐▌ ▐▌    █ ▐▌  █   █    █       █ █ █ █   ▐▌ ▐▌    █ ▐▌  █
  6.    █   ▄█▀    █    █   █    █  █  █   █    █       █ ▐█▌ █   █   █    █  █  █
  7.    █▄▄█▀      █   ▐▌   ▐▌   █  ▐▌ █   █    █       █  █  █  ▐▌   ▐▌   █  ▐▌ █
  8.    █          █   █▀▀▀▀▀█   █   █ █   █    █       █     █  █▀▀▀▀▀█   █   █ █
  9.    █          █   █     █   █   ▐▌█   █    █       █     █  █     █   █   ▐▌█
  10.    █         ███  █     █   █    ██   ▀████▀       █     █  █     █   █    ██
  11.  
  12.              version 2.1  copyright (c) 1984 by Neil J. Rubenking
  13.  
  14.     ╔═════════════════════════════════════════════════════════════════════╗
  15.     ║ ╔═════════════════════════════════════════════════════════════════╗ ║
  16.     ║ ║   If you find PIANO MAN useful, entertaining, intriguing, or    ║ ║
  17.     ║ ║   just plain FUN, please help me continue writing software for  ║ ║
  18.     ║ ║   you with a contribution of $25 (or what you can afford!) to:  ║ ║
  19.     ║ ║               Neil J. Rubenking                                 ║ ║
  20.     ║ ║               300 Page St.                                      ║ ║
  21.     ║ ║               San Francisco, CA  94102                          ║ ║
  22.     ║ ╚═════════════════════════════════════════════════════════════════╝ ║
  23.     ╚═════════════════════════════════════════════════════════════════════╝
  24. ------------------------------------------------------------------------------
  25. ╔═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╤═════╤═══════╤═══════╗
  26. ║ A#│   │ C#│ D#│   │ F#│ G#│ A#│   │ C#│ D#│   │ F#│     │       │legato ║
  27. ╟───┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴─┬───┼───┬───┼───┬───╢
  28. ║  B │ C │ D │ E │ F │ G │ A │ B │ C │ D │ E │ F │ G  │   │Rec│ ^ │   │   ║
  29. ╟────┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬───┤   ├───┼───┼───┼───╢
  30. ║     │ F#│ G#│ A#│   │ C#│ D#│   │ F#│ G#│ A#│   │   │   │   │   │   │   ║
  31. ╟────┬┴──┬┴──┬┴──┬┴──┬┴──┬┴──┬┴──┬┴──┬┴──┬┴──┬┴──┬┴───┼───┼───┼───┼───┤   ║
  32. ║    │ F │ G │ A │ B │ C │ D │ E │ F │ G │ A │ B │ C  │   │End│ v │   │   ║
  33. ╟────┴──┬┴───┴───┴───┴───┴───┴───┴───┴───┴───┴──┬┴────┼───┴───┼───┴───┤   ║
  34. ║       │                                       │     │ Play  │ Erase │   ║
  35. ╚═══════╧═══════════════════════════════════════╧═════╧═══════╧═══════╧═══╝
  36. ==============================================================================
  37. Fig. 1  KEYBOARD MAP
  38.  
  39.     PIANO MAN lets you play your PC's keyboard like a piano.  You don't really
  40. need any instructions to start playing right away.  Look at the NEXT screen
  41. before you start, or screen this whole document for fine points of play.
  42. A description of what you can do at any point will appear on the bottom
  43. half of the screen, so you don't have to memorize commands.
  44.  
  45.     Type PIANOMAN to start the program.
  46.  
  47. ------------------------------------------------------------------------------
  48. PIANO MAN REQUIREMENTS:
  49.  
  50.      --IBM PC or equivalent with 128K or more.  128K gives enough memory to
  51.      record about 3,700 notes.
  52.      --Monochrome or color display in 80 columns.
  53.  
  54.      --The file PIANOMAN.000 ABSOLUTELY MUST be on the same disk as the main
  55.        program, PIANOMAN.COM.  It won't work without it.
  56.  
  57.  
  58. A "NOTE" OF CAUTION:
  59.      In order to grab the signal that is sent when you RELEASE a key, PIANO
  60. MAN changes the way the keyboard responds.*  This change is in effect whenever
  61. the keyboard "map" is showing.  It is imperative that PIANO MAN be allowed to
  62. put the keyboard BACK to normal!  You can't <Ctrl><break> out of the program
  63. while the map is showing, but if you "pound" the keyboard, rapidly pressing
  64. lots of notes  WHILE you are RECORDING, you can crash the program without
  65. giving it a chance to return things to normal.  If this happens, you will just
  66. have to turn your PC off and on again.
  67.  
  68.  *(In technical terms, PIANO MAN replaces the Keyboard Interrupt (#9))
  69.  
  70. ------------------------------------------------------------------------------
  71. ┌───────────────────────────────────────────────────────────────────────────┐
  72. │                                                                           │
  73. │    > ^ and v control the octave.                                          │
  74. │    > <Scroll Lock> = legato on/off                                        │
  75. │    > <Home> = recording on/off, <Ins> = playback, <Del> = erase           │
  76. │    > If Legato is on, rests between notes will not be recorded.           │
  77. │    > Press <End> to end                                                   │
  78. │                                                                           │
  79. │    > Press F1 for advanced melody editing menu, and for saving            │
  80. │    > and retrieving  melody files on disk.                                │
  81. │                                                                           │
  82. └───────────────────────────────────────────────────────────────────────────┘
  83. ==============================================================================
  84. Fig. 2    INITIAL MENU SCREEN
  85.  
  86.      Note that "record" ADDS to the current tune.  To start a new tune, press
  87. "erase".  This means you can enter a complicated tune by recording just a few
  88. notes at a time, and then adjust the tempo in Advanced Melody Editing.
  89.      When "legato" is on, each note sounds until the next note is pressed,
  90. and recorded in just that way.  Otherwise, each note sounds only while it is
  91. held down, and the space between it and the next note is recorded as a rest.
  92.  
  93. ------------------------------------------------------------------------------
  94. ╔══════╦══════╦══════╦══════╦══════╦══════╦══════╦══════╦══════╦══════╗
  95. ║C   4 ║D   4 ║E   4 ║F   4 ║G   4 ║A   4 ║B   4 ║C   5 ║      ║      ║  110
  96. ║2  109║0  218║0  329║0  278║0  170║0  278║0  329║0  380║      ║      ║
  97. ╠══════╬══════╬══════╬══════╬══════╬══════╬══════╬══════╬══════╬══════╣
  98. ║      ║      ║      ║      ║      ║      ║      ║      ║      ║      ║  120
  99. ║      ║      ║      ║      ║      ║      ║      ║      ║      ║      ║
  100. ╠══════╬══════╬══════╬══════╬══════╬══════╬══════╬══════╬══════╬══════╣
  101. ║      ║      ║      ║      ║      ║      ║      ║      ║      ║      ║  130
  102. ║      ║      ║      ║      ║      ║      ║      ║      ║      ║      ║
  103. ╚══════╩══════╩══════╩══════╩══════╩══════╩══════╩══════╩══════╩══════╝
  104. Each box shows note and octave above, Staccato and duration below.
  105. ==============================================================================
  106. Fig. 3  ADVANCED EDITING NOTE DISPLAY
  107.  
  108. In Advanced Melody Editing,          ┌─ the note is "C"
  109. the notes are displayed as           │      ┌─ in octave #4
  110. numbers.                             │      └───┐
  111.                                      │ ╔══════╗ │  ┌───its duration is
  112.                                      └>║C   4 ║<┘  │      109 milliseconds
  113.  ┌────────────────────────────────────>║2  109║<───┘
  114.  │                                     ╚══════╝
  115.  └─its "staccato value" is 2 (i.e., the last 2/10 of its duration is silent)
  116. ------------------------------------------------------------------------------
  117.                                     ╔══╦══╗
  118.              Edit individual notes  ║F1║F2║  Save melody to  file
  119.                                     ╠══╬══╣
  120.                Global change tempo  ║F3║F4║  Global change key
  121.                                     ╠══╬══╣
  122.             Global change Staccato  ║F5║F6║  Round off note lengths
  123.                                     ╠══╬══╣
  124.               Global change octave  ║F7║F8║  Set quarter-note length
  125.                                     ╠══╬══╣
  126.                Play current melody  ║F9║F0║  Retrieve  from a file
  127.                                     ╚══╩══╝
  128. ==============================================================================
  129. Fig. 4  ADVANCED EDITING MENU ONE
  130. NOTES:
  131.   >>"Faster 50%" is not the reverse of "Slower 50%".  (Try multiplying a
  132.     number by 1½ and then by ½!)
  133.   >>You can stop "PLAY current melody" by pressing any key.
  134.   >>"Round off" can be used to set ALL notes to the current Quarter note
  135.      length--very handy.
  136.   >>"Retrieve file" shows you all available files and lets you pick one.
  137.   >>"Save file" allows you to ADD to an existing file.  Thus you can save a
  138.      tune bigger than you can play.  (Why do that?  See UTILITY.DOC.)
  139. ------------------------------------------------------------------------------
  140.        ╔══╦══╗
  141.        ║F1║F2║  Delete lighted note
  142.        ╠══╬══╣
  143.        ║F3║F4║  Insert before lighted note
  144.        ╠══╬══╣
  145.        ║F5║F6║  Edit length of lighted note
  146.        ╠══╬══╣
  147.        ║F7║F8║  Play lighted note
  148.        ╠══╬══╣
  149.  Play  ║F9║F0║  Strip out rests
  150.        ╚══╩══╝
  151. ==============================================================================
  152. Fig. 5  ADVANCED EDITING MENU TWO, pt.1
  153.  
  154. NOTES:
  155.     >>"Insert" puts in a REST.  <r>aise and <f>lat (see next screen) will
  156.        change the rest into the note you want.
  157.     >>"Edit length" allows you to stretch out some notes for emphasis without
  158.        having to go back and change the QuarterNote length.
  159.     >>"Strip out rests" not only removes all rests, it adds their durations
  160.        to the previous note.  You may need to do it more than once.
  161.     >>Press a key to stop "play".  You can edit at the note you stopped on!
  162. ------------------------------------------------------------------------------
  163.                                               ╔══════════════════════════════╗
  164.                                               ║  OPERATIONS ON LIGHTED NOTE  ║
  165.                                               ╠══════════════════════════════╣
  166.                                               ║ LENGTH      PITCH    OCTAVE  ║
  167.                                               ║ <w>hole     <r>aise   <u>p   ║
  168.                                               ║ <h>alf      <f>lat    <d>own ║
  169.                                               ║ <q>uarter                    ║
  170.                                               ║ <e>ighth       STACCATO      ║
  171.                                               ║ <s>ixteenth        <m>ore    ║
  172.                                               ║ <3>2nd  <6>4th     <l>ess    ║
  173.                                               ║ <t>riplet  <.>dotted         ║
  174.                                               ╚══════════════════════════════╝
  175. ==============================================================================
  176. Fig. 6  ADVANCED EDITING MENU TWO, pt. 2
  177.  
  178. NOTES:
  179.     >>Set note lengths (in relation to the QuarterNote length) by pressing the
  180.       proper letter key.  Dotted makes note 3/2 as long, triplet, 2/3.
  181.     >>You can adjust pitch and octave (<r>aise and <f>lat pitch, octave <u>p
  182.       and <d>own), and then try the note with F8.
  183.     >>Press "-" (minus) to change the current note into a rest.
  184.  
  185. ------------------------------------------------------------------------------
  186.  
  187. TIPS ON CREATING CLASSY MUSIC WITH PIANOMAN
  188.  
  189.      There are a number of sample pieces on the PIANOMAN disk.  Here are some
  190. of the techniques I used to record them:
  191.  
  192. >>Either record with LEGATO on or STRIP out rests--the rests make the UNedited
  193. playback quite accurate, but if you're going to edit, they just take up space.
  194.  
  195. >>Record difficult pieces a measure or two at a time.
  196.  
  197. >>If you tend to hesitate a long time over a note, you may want to use "ROUND
  198. OFF" to set all the notes to a reasonable length before you start editing.
  199.  
  200. >>Record long pieces in sections and then combine them, either by retrieving
  201. them one after another or by saving them into the same file with the [A]dd
  202. option.
  203.  
  204. >>Note that PIANO MAN takes a tiny-but-finite time to play a note IN ADDITION
  205. TO its duration.  Thus, 8 notes of duration 100 are very slightly longer than
  206. one of duration 800.  However, this time-lag is infinitesimal in the files
  207. converted by PLAYER PIANO.
  208. ------------------------------------------------------------------------------
  209. PIANO MAN USERS:
  210.  
  211.      If you register your use of PIANO MAN by sending the requested contribu-
  212. tion, you will be eligible for free updates and information about related
  213. programs.  Next version (when I get around to it!) will probably include BLOCK
  214. operations (copy, delete, transpose, rallentando, &c.) and another input mode.
  215.  
  216.      If you produce some real musical gems with PIANO MAN, I would appreciate
  217. your sending them to me.  If you send a disk in a disk mailer with return
  218. postage, I will copy onto it any other tunes I receive and send it back.
  219.  
  220.  
  221. Neil J. Rubenking
  222. 300 Page St.
  223. San Francisco, CA  94102
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231. ------------------------------------------------------------------------------ #